TO_DATE-Baustein
Kurz-Information
Name |
|
→POE-Typ |
|
Kategorie |
Standard (non-safe), ConvertEnh, Baustein mit interner Fehlerdiagnose |
Konform zur →IEC-Norm |
so nicht in IEC-Norm vorgesehen (siehe "Explizite Konvertierung laut IEC-Norm") |
Grafische Schnittstelle |
|
Verfügbar ab |
Version 1.65.0 (für Neuron Power Engineer) – Anfangsvariante Version 3.8.0 (für Bibliothek |
Funktionalität
Der Baustein dient zur expliziten Konvertierung des am Eingang IN
anliegenden Werts in einen Wert vom Datentyp DATE
.
Falls der anliegende Wert im gemeinsamen Wertbereich des Eingangsdatentyps und des Ergebniswerts DATE
liegt, so liefert der Baustein diesen Wert. Dabei wird der anliegende Wert auf Sekunden-Basis konvertiert, und zwar relativ zur Untergrenze D#1970-01-01
von DATE
(siehe unter "Beispiel für Verwendung im ST-Editor" und "Wertbereich für Konvertierungen" für Unter- und Obergrenzen pro Datentyp).
Explizite Konvertierung laut IEC-Norm
Die IEC-Norm sieht eine explizite Konvertierung der folgenden Datentypen auf DATE
vor:
LDATE_AND_TIME, DATE_AND_TIME
Der Datentyp LDATE_AND_TIME
wird derzeit von Neuron Power Engineer nicht unterstützt. Für die Konvertierung des Datentyps DATE_AND_TIME
ist auch der IEC-konforme Baustein DT_TO_DATE
verfügbar.
Eingänge, Ergebniswert
|
Bezeichner |
Beschreibung |
|
---|---|---|---|
Eingänge: |
|
|
zu konvertierender Wert |
Ergebniswert: |
– |
|
|
Der Eingang EN
und der Ausgang ENO
sind für den →Aufruf des Bausteins verfügbar. Siehe "Ausführungssteuerung: EN, ENO" für Informationen zum Eingang EN
und zum Ausgang ENO
.
Informieren Sie sich unter:
-
"Bausteine für sichere Logik", ob dieser Baustein für das Entwickeln von sicherheitsrelevanten Anwendungen unterstützt wird.
-
"Kennzeichnung von sicherer Logik im FBS-Editor", welche Auswirkung die Verwendung des Bausteins als Baustein für sichere Logik hat.
Interne Fehlerdiagnose für Baustein
Der Baustein prüft vor der Ausführung den Datentyp des an IN
anliegenden Werts bzw. den Ergebniswert. Der Ausgang ENO
des Bausteins wird auf den Wert FALSE
(oder eine Entsprechung) gesetzt, falls:
-
der Datentyp
TIME_OF_DAY
. -
es sich um den Datentyp
LINT
,ULINT
,REAL
oderLREAL
handelt und dafür ein Ergebniswert <DT#0001-01-01-00:00:00
oder >DT#9999-12-31-23:59:59
geliefert werden würde. Der Ergebniswert wird auf den entsprechenden Minimalwert bzw. Maximalwert gesetzt (siehe unter "Wertbereich für Konvertierungen").
Beispiel für Verwendung im ST-Editor
Die berechneten Werte werden mit Hilfe des Assert
-Bausteins ausgewertet.
|
Bei der Erstellung Ihrer Anwendung im ST-Editor erstellen Sie den Aufruf eines Bausteins, indem Sie den laut Syntax erforderlichen Text eintippen oder die Inhaltshilfe verwenden.
Wertbereich für Konvertierungen
Der Wertbereich für die Konvertierungen wird durch Untergrenze und Obergrenze der Datentypen bestimmt. Diese Untergrenze und Obergrenze pro Datentyp sind unter "Unterstützte Datentypen (in ST)" angeführt. Beachten Sie: Die Untergrenze für DATE
bzw. DATE_AND_TIME
ist für Literale gültig. Aufgrund von Berechnungen oder Konvertierungen kann Neuron Power Engineer Werte bis zu DATE#0001-01-01
bzw. DT#0001-01-01-00:00:00.000_000_000
verarbeiten und darstellen.
Die folgende Tabelle zeigt jene Literale für IN
, bei dem der Baustein den kleinsten möglichen bzw. den größten möglichen Ergebniswert liefert (bezogen auf den Datentyp für IN
), der auf allen Zielsystemen verarbeitbar ist. Abhängig von Ihrem Zielsystem ist es möglich, Literale zu verwenden, bei dem ein Ergebniswert > D#9999-12-31
geliefert wird.
Datentyp für IN |
Untergrenze |
Obergrenze | ||
---|---|---|---|---|
Literal für |
Ergebniswert |
Literal für |
Ergebniswert |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|